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RSX?.HD SPEC 



T0j RSX-llD nistr Ibytlon 

OATEl 22 Jijne 72 

SU9J5 TASK INSTALLATION 

,00C{ 13*l-X21-P33-00 



The material Included To this functl-snal 
spec! f IcatTon, incTucilng but not | Ifnl tecj 
tO| Instruction tl^es and oneratjnrj 
s&eeris Is for Infofrraifon ou''dcs*»s onjv, 
A|r sucn material Is subject to chf'nga 
wjthQut notice, . Conceqyent i y DEC nsKes 
no cial'-n and shall not be llaoie for Its 
accuracy', 



Unless sdeclfled otherw!se» the ter^is 
"RSX" and "RSX-li" If.ply "RSX-liD"-, 



TASK r-^'STALLUlOM 



PACE 



INTRODiiCTtON 



Task instalUtlon wITI consist of twc t^-sk's, The 

Binder Jill oerfor. f ^ ' ' nK, n, of t.e tas. .no op n 

Install tne tasK", Instaij wfl! install a ^^^ i 
systei that has Jeon &ul!t by the Task dulldep. 



The Task 

al ly 

the 




priority andi default oartjtiors', 

install Is an mor function that enters a tas^< that ^^'^^s he.n 

u t t> the tas.oul.d.r Into the rs.-Ud sys - .sta 
optionally aataoilshes the, user^s osfault oartitlon 
default pf ior Ity', 
Task 8y| rolnq of an RSX-11.0. Task {s the process of ^r^-aUng 

1 n? i^usN.s. I.a.e on a .is. -d option., !y a. ent v 1 

?s:3ri:s.irc2;;%rG^;/;?:j::3rJc^"--!oS Ta.. o. 

I/O Handle^ TasK^s, 

The following !3 a list of the major ooeratlons ro'^uU^^z to 

build itas.; They ar. iTste. 1n tne orcer |n uhU^ tn.y 

areoerfor'^ed; 



90 

be 



1, Alhcates oTsk storage for the user ta.^ wi 
tie tasK nare as t^e f I 1 9 /a^e and f I n^s a t r 
Syste-^ Task u] rectory entry If tn. task ,s to 
|nstal led, 

2, Allocates ASH'S for Global Common an-^; System 
Lists*, 

3, heads object modules and relocates gener '=.t I nd 
a memory i'n=*'3'5 on a alsk, 

4, conditionally Relocates routines fro,-, the User 
Library', 

5, condltlonairy Links to memory Res|d«".nt Library 
routines, 



» .. only DrTvIUdiad tasK's are provMed a-.cess 
to List's, Tables, 5yste.r. SubrouJres, anq Lyt^mai 
page, 



TASK INSTAULATIOfJ 



PAC-E 3 



6, Condf tlonal'ly Mjocates. routines from the 
Syste-n Ulbrary, 

(Relocation fs in |s Incpeaslnn virtual memory,) 



CONTROL .STATfiENTS 



The following Is a description of the t^sk Oujlder Control 
Statments, The Syntax Is defined In ?^0'l|flea B^T usJi^Q x*^e 
^Oijowlno conventions and definitions; 

Angle bracKets delimit niQta | Ingu 1 st I c variables/ 

Quote marks Oellrrdt a character strlnq, 

A slash (/) I nafcatas' a Ttnrrat Ion i,OH) , 

No operator IndlcstQs concatsnat I ini 

parens Indicate f ?ictyr i ng, 
CARRAGE RETURN 1-^0! |es jtne cent I nuat | on necRSSary 
AUThPDEI iTiolTes no continuation necessary 

fSi IrdfcatPS any nu^nber Clncludlng zeroj of| 

'NUL' Indicates ibe er^pty set, 

<QC> \\' Space or BlanK or co^rna 



• t 



" .'"' / •• 1 " / " 2 V / '» 3 •• / !» 4 »< / II 5 •• / •( 6 »f / II 7 •« / 1. 1 II / n 9 >i •■ 
"A'V"b"/"C" .',.,;;,,,'. "Y"/"YM/i»2!'; 



<OIGiT> 

<LETT="«> 

<MAfiE> s:= Cl,6l{<LZTTER>/<DiGIT>); 

<CR> ] != CAPHiGE '^ETiiRN 

<AM> Ms ALT.^nDr 

<TC> ?:= <CP>/<AM>J 

<NBC> ;j= Non BroaK Character 



Install Ts an MCR Tunction task that in5<?rts a'tpsi/ into x'-e 

SystcTi Task Directory, The Task f^ame Is f^e file nana, T>^e 

Task .^anie, Default ?=irt|tlon, and default priority are 
specified In the f o j low.' i nj syntax I 

MCH SYNTAX ::= "!NS"'5<ND':> <9C> <TASK nave> <bc> 

<nEfAiJL^ PAflTITlO'-I N'A'^E> <BC> <CErAUi.T PRIOPITY> <Tr>j' 
<rA5K 'lAME > ! := <":AME>; 

<uEFAUl,T PARTiTION> ?:= <NA,1E>} 

<DEFAUl,T ?R10HITY> :;= <DEClMAL VAUUE>I 



EXAMPLE} 

MCR, piS' jOE,PAH,<niJ 



TA^K INSTAULATIOM 



PAr-E 



following ^CR ^unction syntax} 

MPR SYM7AX :j= »TK3"?<NBC> <8C> <TAS'< \'a^E> <8C> 

<oIrA'iLT PARTinOM NAVE> <yc> <DEFAnuT PHIQRITY -fu 



NinE?^> 



<TC>} . 
<TAS''< NA^^£> !5= <NA^'.F.>} 

<UrF'^UL,T PRIPBITY n'uM6ER> i;= <DEC!M^L ML'. 



IE>» 



EXAMPLE I 

ncR, TKB jnEiPAP,4''0 

TASK MAME .- PSX TasK's are Identified by ^'aT.6■5 
that are sp.cTfUd when the Tas-s are mstaHec 
These naoifis are inceoenrtant of ^^ogra^ t,..I ' 
na^es. TasK Mar.es ape the names cr the t^^.-<s ^ 
Sr n^ltaiud, inu win b^ ^^: ^'^^^^,,,^^' '^ 
inserted In the System Task Directory (Sjn), 

DEFAULT PARTITION " Default Partition Is th^ 

Lorv partition ^^ ^^^^.^ ^^^l^l '"^JIJ^^^V^ 
soecincally over r I ^aen xhen the taSK s e.<8c.juiw 

js reauestedi ■ 

DEFAULT ''RIO^ITY - Cefault Priority Is tn^ 
orlrrUy unarr which the T?.sk *' i I I run gnins^. . 
S^JtllHn ?s sPeclfU^ wnen the Ta.K's execution 

jsrenuest.ed, 

After The TasK Builder has validated ^^^ ^'^ ATl^'ll^ is 
will will outDut pr'or^ptlrg synbols and accept r^.conr^e. :.s 

descr I *^ed he lo''', 

OPTION"? 

- 1. Til* +vr!3 :.n "OPT IONS J" D r C-iP 1 1 -"Q r>ynpO I 

The Task aullcer "Tit tyna an ur"*u.* i 
an'1 accept responses of the foHowng syntav, 

OPTIONS {:= ^^ <0PTICN> / <TC> )1 

<0PTIG'O :-.= <CFT10N SYf-,RQL> <TERhlNATOR> J 



-- WHEM °ATCH ly IHPLEME^'TEU, THE TA?K B'-'ILDES 
II OPFRATE UNOEH BATCH AND NOT U^'OZ^ ^',':H, 



WlUt O^'Ef^ATt UNOEH 



TASK I^STAILATIOM 



PACE 



<ootIon sy.Dbl> n= "pt V"nmV"sa"/"cp Vnf VMn" J 
.<1;er'n|nator> J|= <tc> / <SDace> <ODtlon>| 



opt lonsi 
options»pt|rMn,sz«C0 



The option symbols have the following neanlnqs; 

IK ,. Insert an entry for th(s ta^K l« th« System 

TasK 01 rectory <STD) , . 

NF^- declJire thjs task to De a tafK that will not 

use t^e floating point unit', 

PT — A Prlvllednad Task Is a task that ha-? 




WM „ No load mao prevents the loaa map fro-n beinn 
prlht^'l as the tasl- is being MnKed, Th^Tas- 
BuUaer progp^ni normally prints t-e Mad -ap, 

SH — STze of task. This option cause the size of 
the user tasK to be orlnted «.fter I^ ^as been 
llnKed, 

CP - Checioolntahia tasK. This options causes 
the disk allocation for chscWpolntlng anrt Dorn'Its 
the task to reqyest cbeckoolnt I ns, 



STACK AReA 



Stack soac 



e Is aliocatec I r, Increasing rnemorv ^fo^ virtual 
Tocaton t.o ^I rtua 1 ^ zero I s always used for D , r.ctv^ 
atatusi. vlth tr\Q Task's i>tacr< Pointer set; .0 T.n« /"^ '^ 
address' tr, The Stack Apea Is free -^e^ory anu need MOT be 
used exclusively f-^r Stack storage, 

The Task dullaer outputs a '5TAuk ,Tparn.<.in. 
accepts a response of tne fofjowlng syntax! 

STACK AREA J!= uPosiTive OlCImal va'jjO/n'Jl) <tc>; 



TASK riSTAULATlON 



PACc 



If no StacK siza !s specified, an area of 31. worrJs Is 
a I located , 

Cxa.TiP jes! 

STACK|75 
STAC<{ 
STACK 10 

POOL LIMIT 

Pool Limt Is the number of Pool ^^ode3 t^at -"av be l"- 'JSe by 
a Tasi at any one tl-^a. If no Poo. Ul-lt Is SwecifUc a 
default pocj limit of flvu ncdes wiM be allocated. T«^e 
Task BuTi^er outputs a "POOLJ" Dfomotln9 ^y^&o | a,na acc^-cts 
a fespcnse of tne foliowinti syntax? 

POOL L.IfiIT ;;= ^POSITIVE DECIMAL VA'.'E>/^'UL) <TCM 



example: j 

P00L«lf5 
POOLJ 



USeR LIS 



User Lib requests the Inrut of the nax.fi of t^e user 'Ibrarv. 
If any. to oe spedftaa, The Task duMder wMl tyoe '.^rn 
ilp,"';,d axcent a user' Literary na-^e In tn. following 

syntaxJ 

USER LIB NAM ?J= (<L!BHAPY N/,Me> /MUD <TC> i 



<LI0^A''Y NAME> :}= <riAM£>J 



f:xample; 

USeR LIS5LIEP. 
UiiER LIB! 



The User Library Mame Is ootlnnal and |t will cause an 
Indicated user pre. Med library to ^8 scann.o Po s-^^^f^y 
unresoivpQ Olobal sy^om references) r.oforc a-^y ot.n^r 
Mbre?y IS scanned-. Routines fro^i a user L brary ..re 
Jelocatodanl Incluaea as a Purt of tne TasK lead irnag., 

GLOBAL COM 



TASK INSTAULATIOM ^^^'^ 



The Global- Comn-.on fs usad for Inter-TasK communications and 
«xtrH-Task data storage. Install may ^e l^-r'^^*^^ ""^.H^ \ 
Task«-s references to elements of a -aned Common jnto a 
ctobal cUmon of the same na^e. w|tn «^t-.8r reao-only o 
fiad/irjte access, Tne TasK Builder wHt tyne '^GuOoAL ClhJ' 
and accept Global Com,i^on names In the follPwInq syntax? 

GLOBAL COM. ;:s <coMMON .namo (^/♦<co«mcn name:>) 

e<ACCES3 COUr> /NUL) <TC>i 
<COMMO'I NAME;> '.!= <'NAME>| 
<ACCF.SS COr)£> ;?s -RO'V'RWJ 

EXAMPLE? 

GLOBAL COMjCOMA/R.w 
GLOBAL COMi 



Each Global Comrtion referenced reaulres one ASR for each 4K 
of storage area, 

N'JM LJ^'S 



The recuest Nun LU'ls sueclfles the nu.Tif^eF of uU -s that I 
be allocated tc a tasK. Tne Task -wilder wM| tvoe M. 
LUNiJi" ano accept the nu-^oer of uW^'3 In tne follow^ 



Lg^:i>l 

syntax! 



NUM LL^'S ;J= <CCTAL VaLUE> <TC>! 



EXAf.PLE: 



Nu'^ L^^^SI 



OErAULl AGSIGN'^ENT'? 



Oefau 
Any 



^,t Asslgn-tients allocs a Tp-sK's LU'^s to be or cass I gnec!', 
UJ''s not assigned w|M default to "non^" (unas". 1 nn^d) , 




default assjqnnants In thd foljowirg synxax; 
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OEFA'JLT ASSIGNME'-'TS JJ= <ASSIGMfir.NT> i 

<OFvice NA^^£>tl= <LrTT£:R> <LETT?.f^>J 

<g;u''' NUMBZK> I is <ocTAL vali-ie:>» 

<LUNS> S!= <L'JN> <Tc-^M>i 

<Luw>' J j= <uF.ciMAL yauc:>j 

<TER^> 8«3 <TC>/(<rfC> <LUN?>); 



EXAM^'LEI 

TT'5i4i5,3 
TT1J6 



Resident code defines tne file na'nes o* tho object ^oagt«s 
that % e to be ! InKad to for. the u.er ta.K l:-l^\j;ril 
ftniLt nocuies wiii be MnKeH in the order In whic'^ th«y are 
soicinei ^e U' Rullde. will tyo<^ "r^alc.nt coci.f .nd 

accept th; r^l.dent code modules in tn« following syntax, 

RESinEMT CODE J ? s <Mf:DtlLE FILE MAMF.S> <TC>I 
<rtOLjUtE FILE .Na:'.E5> ;;- (<mQDUIE .\AHr>/NUL>J 
.■<MODULE NA^1E> !|5 <NAHE>5 



GENEf'AL n^SCRIPTIO^; 



TasK Directory entry for oac^^ tas'K, 

Install Is a sinole task that inst^-.ll'sa tasK Into the -^yst.m 
by maMn. an entry Tn tne System T.sk ^Ir^ctorv (STO), Tne 
tasK .-nust have roen nrevlogsiy buMt cy tne Ta^^. b-jUvier and 
the fJiQ name must be the sa-r.e as the tasK na.r,.:!, 

DISK ALLQCATIOVj 



TASK I^^STALLATION 



PAGE 



Thfl TasK otill'def allocates and zeroes contjqgnus space on 
the snecifled disk for the f«sTdent oo^e (excjUTlng niou^l 
Common, PG-ontrant ITtJrary and sy«5te,n list's) o^ a us^r 
task', If tne task ts Chftckpo j ntab 1 e The Task Builder will 
.a|s?i allocate additional space to save tne ci^eckpo I nted tasK 
Image, 

Ast? aluocatio.>i 



Fop a|! Privileged Tas^^s, use of the virtual address snace 
from 06STiJ'^i thru 177777 (A"R3-ASn7) I s. D r e-acf | nfid . Aidr8r,s 
space iA^?33-177777 '(aSR7) Is manoca Into tne POo-ti 
Externni Pago, Address scace 102CfJ3-157777 (ASF<s 4, 5 ^ 6) 
?s mapoed Into the executive's sdacq for access to "sy^t^m 
tah|fls# lists, pool* and executive subrout | n^s . A'fdress 
sps.ce n6'"^^^g-J77777 (ASRi) Is usea by th*^ Ta^K tn access all 
memory (via run-t i ne . a | tef at 1 on of Its co^tf^nts), and .1 ts 
contents are not prescribed by The Tas^ Rul Icier, 



Addresn space ?cn0?2-057777 (ASRs f, IS 2) cf 
Taaks,- an"^ all menory address soace of non-PrJv 
Is a! located as foi lows? 



P r .1 V 1 I 3 G ^ d 
oged Tasks 



from 

AS^'2 

"sach 
Msea 



Me-nOFy snace Is allocated for access to GLOBAL COm^'ONs 
tne too (Starting wfth A3R7 for non-Pr i v | I.ened Tasks « 
for PrlvMeqeH tasks), One ASP Is used ^or 
GLOBAL COM^'OM (jess tnan 4K) useri, Ac^Itlonal aSHs are 
for GLOQAL C'TM^'QNs that are qr^ater than 4X words, 

If references to tVio . Res i dent L ' brary ^r^ macsi .sufficient 
Asns to map Into the entire library are allocate:: fmm f-^e 
too down', 

ASPs for tt^e Task execution Mncludjng routl-^es fron a Osrt 
and systerr medlu^ llbrf>.rv) are allocat<?d fro-^ th^ bottom uo. 
A59'S are roxpleteiy situp for the tas-^'s nxscutio^ av T'^e 
Task Sglider, The cnly cn^nqes th-'t the systei naods to 
make at request tfne Is to set up the ohyslcni location 
ofthe user coca, This js determln^a at exocutlon by tbe 
Partition that |s specified wncn the t^sk Is requostad, 



RELOCATION PRGOEOUPE 



A|l task's will be relocated In physical cor«^ oy the 
segmentation unit (KTlD, Tne usftr codR ^ni fre^ core rnur.t 
be contlauQus but It iTiny be anywhere |n ohvslcaj crre. The 
tasK'' wi!|. appear to start at location ?> and axnano u'^w^rli 
In Virtual me.tiory 'as specified fn ASR Allocation ), a ijs«r 
task inay be any size to a maxlr.um of 32k, T^e Gio'^al Ooimrn 



Task imstaulatio^ 



PAr.E la 



and user library are included (n the size of too task and 
may. not be contiguous In vfrtgal or physical memory, 

Mamopy |s allocated In the following soquencaJ 

If the tasK Is a Prlvjledsf^d Task AS97 Is Inltaljzed fof tbe 

External Paqe, ASR'S 6,5{« are the^^ used as necessary to 



oepfnlt access 
Subrout inos , 



to 



the systeiti |lst>s and re-fir.trant 1/0 



Global Com-^on Is ailbcatod first since [tfs s|7e, 
and c^araoterlstlcs are Known Sefore the Object Modul'JS 
T Inked, The Gjohal Common joafs using the first 
(ASR7 If not a oflvil'sdaed task); 



( C ?. t T n , 

are 

f roe , 



a«;r 



Task fs 

ahove i^Q 

rhR I'scr TarK 

< &S'^^-') ?nrt «xni"0 



After the Gjooaj Common Is allocate" the user 
■•VinKed, The aase of the user task starts Just 
Free Core snd "ust be nhysl ca j 1 y cent I nuous , 
and ■ free Core always start from vlrtuaj 
goward^ Tn Virtual mefnory, 

Tne we-entranfc position Indeoerdent System Library 
tl'^RAHV, tie,) Is the last segi-ient to oe llnKsd, 
usp tnfi re-r'-»lnln-5 *SR'S, The Library "^ I I I "^ave 
prTv!|ea«305 to protect It ngainst acciclental dPStructlnn, 

SYSTEM TAS^ OI^ECTnRY FNTRYj 



(FHRTf-AN 

It will 

read on I y 



The Task Builder and Install 
Syste-n TasK a i rectory, Th 



w 

I 3 



I nake' an sntrv i "^ t'~e 
entry ■•^' M 'no iud« the Teck 



Kamei 'nefaJit Partition, ana Uofr.ult Pr|orltv us ..srecifjpa 
the Svsten List's Snec, The Task Insta I 1 ^ t i on- w ! t I 



In 

Insure that tn«r« are no conflicts |n TasK 

Dafa'''etorsofth3task, 



va.Tes or othpr 



